publishMetadata

Returns a list of songs that have changed (according to the song edit date) since a specified time or since the last time this command was called.

Sample Request

<mmRequest command="publishMetadata" station="ID" [version="1"] [client=""] [userData=""]>
	<contents>
		[<properties>
				<property name="lastedit">2015-01-01T00:00:00</property>
		</properties>]
		[<fields>
			<field id="12" />
			<field name="Artist" />
			<field name="Title" />
		</fields>]
	</contents>
</mmRequest>

Request Notes

This command basically performs the same operation as if you used to search for songs where the last edit date (field 27) is later than a specific time. If you wanted to return the entire library, you could set the time stamp to a long ago year, like 1899. This command does record the last time it was called and will automatically return the list of songs changed since that time if no date/time is specified.

 

"last edit" - This is based upon the date and time and is designed to return songs that have changed since a specific time. The time of the latest change it returns is saved so the next time you can call this without the lastedit property and it will automatically give you anything changed since the last time. If this returns some changes, it will note the date/time of the most recently edited element and return any songs changed after that date/time the next time the call is made.

 

While MusicMaster has a way of automatically tracking timestamps, it does so only overall, so if more than one system will access the Nexus Server, we recommend the third party system include and manage this time stamp.

 

If you wish to include additional song fields, specify those in the options “field" section.

Sample Reply

<mmReply command="publishMetadata" station="ID" version="1" [userData=""] status="ok">
	<contents>
		<songList recordCount="2">
			<song songId="1" />
			<song songId="2" />
		</songList>
	</contents>
</mmReply>

Reply Notes

By default, this command will only return the song ID of the songs that have changed. You can include the options Fields section in your request if you wish to return additional data.

Compatibility and Version Info

Available in MusicMaster PRO 5.0sr15 and later

 

This command may have a vendor specific override available and when that is the case, this command may be automated to push changes to your automation system by adding a command to the Interface section of MMServer.ini when using MusicMaster PRO:

 

PublishMetaData=[interval]

Where [interval] is specified as the number of seconds (S,n), minutes (M,n) or hours (H,n) between calls to this command. Example: PublishMetaData=S,15 (will call this command every 15 seconds)